package com.ruoyi.pack.service;

import java.util.List;
import java.util.Map;
import com.ruoyi.pack.domain.PackWarehouse;
import com.ruoyi.pack.domain.PackContainer;
import com.ruoyi.pack.domain.dto.FenceOperationResultDto;
import com.ruoyi.pack.domain.dto.PackWarehouseSummaryDto;

/**
 * 仓库Service接口
 * 
 * @author ruoyi
 */
public interface IPackWarehouseService 
{
    /**
     * 查询仓库
     * 
     * @param warehouseId 仓库主键
     * @return 仓库
     */
    public PackWarehouse selectPackWarehouseByWarehouseId(Long warehouseId);

    /**
     * 查询仓库列表
     * 
     * @param packWarehouse 仓库
     * @return 仓库集合
     */
    public List<PackWarehouse> selectPackWarehouseList(PackWarehouse packWarehouse);

    /**
     * 查询仓库列表（用于导出，包含关联名称信息）
     * 
     * @param packWarehouse 仓库
     * @return 仓库集合
     */
    public List<PackWarehouse> selectPackWarehouseListForExport(PackWarehouse packWarehouse);

    /**
     * 新增仓库
     * 
     * @param packWarehouse 仓库
     * @return 结果
     */
    public int insertPackWarehouse(PackWarehouse packWarehouse);

    /**
     * 新增仓库（包含围栏信息）
     * 
     * @param packWarehouse 仓库
     * @return 结果信息，包含创建的围栏ID列表
     */
    public Map<String, Object> insertPackWarehouseWithFence(PackWarehouse packWarehouse);

    /**
     * 修改仓库
     * 
     * @param packWarehouse 仓库
     * @return 结果
     */
    public int updatePackWarehouse(PackWarehouse packWarehouse);

    /**
     * 修改仓库（包含围栏操作）
     * 
     * @param packWarehouse 仓库
     * @return 结果信息，包含围栏操作结果列表
     */
    public Map<String, Object> updatePackWarehouseWithFence(PackWarehouse packWarehouse);

    /**
     * 批量删除仓库
     * 
     * @param warehouseIds 需要删除的仓库主键集合
     * @return 结果
     */
    public int deletePackWarehouseByWarehouseIds(Long[] warehouseIds);

    /**
     * 删除仓库信息
     * 
     * @param warehouseId 仓库主键
     * @return 结果
     */
    public int deletePackWarehouseByWarehouseId(Long warehouseId);

    /**
     * 删除仓库信息（包含围栏信息）
     * 
     * @param warehouseId 仓库主键
     * @param force 是否强制删除
     * @return 结果信息，包含删除的围栏信息
     */
    public Map<String, Object> deletePackWarehouseWithFence(Long warehouseId, boolean force);

    /**
     * 校验仓库编码是否唯一
     * 
     * @param packWarehouse 仓库信息
     * @return 结果
     */
    public boolean checkWarehouseCodeUnique(PackWarehouse packWarehouse);

    /**
     * 导入仓库数据
     * 
     * @param warehouseList 仓库数据列表
     * @param isUpdateSupport 是否更新支持，如果已存在，则进行更新数据
     * @param operName 操作用户
     * @return 结果
     */
    // 导入功能已移除，如需使用请取消注释
    // public String importWarehouse(List<PackWarehouse> warehouseList, Boolean isUpdateSupport, String operName);

    /**
     * 库房汇总统计查询
     * 按编码、类型、库房、项目、状态分组统计器具和物料数量
     *
     * @param packContainer 查询条件
     * @return 库房汇总统计结果
     */
    public List<PackWarehouseSummaryDto> selectWarehouseSummary(PackContainer packContainer);

    /**
     * 获取库房汇总详情列表
     * 根据库房汇总条件查询具体的器具列表
     *
     * @param packContainer 查询条件
     * @return 器具列表
     */
    public List<PackContainer> selectWarehouseSummaryDetail(PackContainer packContainer);
}